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PREFACE 



This manual describes the DOS-15 System Generator Utility Program, 
DOSGEN, and gives other information needed by the System Manager 
for installation and maintenance of the DOS-15 system. 

In the preparation of this manual, it was assumed that the reader 
is familiar with the Disk Operating System (DOS-15) , including its 
Monitor, and the several Utility Programs — especially PIP, PATCH, 
and UPDATE. The DOS SOFTWARE SYSTEM, USER'S MANUAL (DEC-15-MRDB-D) 
describes the general operating procedures for DOS-15. 



PDP-15 UTILITY PROGRAMS MANUAL, (DEC-15-YWZB-D ) 

The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the operation and use of a PDP-15 
Utility program. The set of manuals which make up the Utility 
Programs manual are listed in an Applications Guide located on the 
following page; the Guide also lists the order number of each manual 
and indicates the currently available monitor systems under which the 
program will operate. 

Individual utility manuals may be ordered by referencing the titles 
and order numbers specified in the Applications Guide. A complete 
set of utility manuals may be obtained by ordering "PDP-15 Utility 
Programs Manual, DEC-15-YWZB-D" . 
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APPLICATION GUIDE 



PDP-15 UTILITY PROGRAM MANUALS 



PDP-15 Utility Program Manuals and the Application of Each 



Title 


Manual 

Order Number 
CDEC-15-YWZB_) 


Applies to Monitor: 


DOS 


ADV 


B/F 


DDT 

Utility Program 


DNl 


/ 


/ 


/ 


CHAIN & EXECUTE 
Utility Program 


DN2 


/ 


/ 


/ 


SGEN 

ADVANCED Monitor 


DNS 




/ 




MTDUMP 

Utility Program 


DN4 


/ 


/ 




PATCH 

Utility Program 


DNS 


/ 


/ 


/ 


EDIT 

Utility Program 


DN6 


/ 

V 


/ 


/ 


UPDATE 

Utility Program 


DN7 


/ 


/ 


/ 


LINKING LOADER 


DNS 


/ 


/ 


/ 


PIP 

ADVANCED Monitor 


DN9 




/ 


/ 


SRCCOM 

Utility Program 


DNll 


/ 


/ 


/ 


SGEN 

DOS Monitor 


DN12 


/ 






PIP 

DOS Monitor 


DN13 


/ 






Disk SAVE/RESTORE 
Programs 


DN14 


/ 


/ 


/ 
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DOSGEN 



INTRODUCTION 



Sections one and two of this manual describe DOSGEN and its use. 
Section three describes the general sequence of operations to be 
followed when using DOSGEN. It is recommended that the user read 
the entire manual before installing DOS-15. 
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DOSGEN VIA 



1.1 Context 

The DOS System Generator, DOSGEN VIA, allows the system manager to 
modify an existing DOS system to suit the needs of a particular in- 
stallation. DOSGEN does not create a system, but modifies an exist- 
ing one. The DOS disk restore DECtapes or magtape that Digital Equip- 
ment Corporation distributes will produce a working Disk Operating 
System when restored to the disk via the DOSSAV program' . The system 
manager may initiate a system generation operation in order to tailor 
this basic system to hils own needs by issuing the following series of 
commands to the DOS Monitor: 

MICLOG SYS Required System Manager Password for the basic system 



or 



A DK ^^14 Cfor system generation on RF DECdisk) Required AS- 
A DP ^14 Cfor system generation on RP Disk Pack) SIGN statement 

SGEN Load command for DOSGEN 

When DOSGEN is loaded it automatically starts an interactive SGEN pro- 
cedure. Once system generation is complete, the system manager should 
save the changed system via the DOSSAV program. He should always re- 
tain at least two copies of the system: the original tape(s) from DEC, 
and a copy of the new system. 

Should the system manager wish to do a subsequent system generation, he 
should type the same command series given above, substituting the Master 
Identification Code which he supplied during the last system genera- 
tion. 

1.2 Organization 

DOSGEN is a single, core-image system program with no overlays. When 
loaded into core DOSGEN tests to ensure that the system owner is cur- 
rently logged in and that the "A" handler of the RF DECdisk or RP Disk 
Pack is assigned to .DAT-14. DOSGEN will exit if these requirements 
are not met. DOSGEN then types out its name, version number, and the 
device and unit number on which the new system will reside. 



Appendix a describes the DOSSAV program. 



DOSGEN then proceeds with eight sequentially presented sets of ques- 
tions that can modify three basic areas of the system: (1) system 
parameters, (2) I/O, and (3) system programs. The eight sets of 
questions are identified by the letters A through H. Each set is 
started by a key question that describes the drift of the questions in 
that particular set. Key questions start at the left margin, questions 
within a set are tabbed one stop (8 spaces) to the right. 

The user can save time by refusing to consider questions in a parti- 
cular set involving an area not to be modified. He can do this by 
responding to the key question of any set with a Carriage Return, which 
effects the acceptance of a set of default answers. This means that 
the parameters covered by the rejected set will remain as in the pre- 
vious system. 

DOSGEN provides restart points which coincide with the beginning of 
each set of questions. In general, a CTRL P from the keyboard at any 
point before the end of the current set of questions will cause a re- 
turn to the start of the current set of questions, and the deletion of 
all answers previously supplied for the current set. Before the user 
terminates a particular set, therefore, he should check all answers 
for that set. If he later finds a mistake after a set is completed, 
he will have to abort the operation and go through another complete 
system generation to correct the error. A CTRL C at any time before 
the end of Section H will terminate the system generation, leaving 
the old system unchanged. 

1.3 Answers to DOSGEN Questions 
1.3.1 Teleprinter Command Mode 

To save time, DOSGEN supplies a default answer with each question in 
parentheses. The default answer always shows how the previous system 
looked or in some way indicates no change is required. A Carriage 
RETURN response indicates the user accepts the default answer. In 
the illustration of each question where the default may be more than 
one, this manual will indicate the possibility with brackets ( {} ) 
Thus: 

API {g)} 



Y and N are one-character answers for many of the Yes/No, On/Off class 
of questions. They are self-explanatory. In the case of some ques- 
tions, however, a third one-character choice is required. In such 
questions, the third choice implies "Yes, but ask me questions about 
the details of the subject." For example. Section B, which concerns 
devices and device handlers, first asks about each device, deferring 
questions about its handlers until necessary. Thus, the question: 



PR? C$) 



asks whether the user wants the Paper Tape Reader. "N" says "NO, de- 
lete the Paper Tape Reader and all of its handlers and skips from the 
system." Response «$" or Carriage Return says, "YES, keep the Paper 
Tape Reader and all its handlers and skips as they are." Response "Y" 
s^ays, "YES, keep the Paper Tape Reader, but ask me questions about 
its handlers and skips." ALT MODE alone will be echoed "$", and sub- 
stitutes for "$". For the Y/N/$ type of question, which accepts a 
one-character answer, a left arrow will imply the default and give a 
visible answer on the printout. (Carriage RETURN is not a printing 
character. ) 



Some questions allow multiple answers; for example, "SKIP MNEMONICS 
IN ORDER" (paragraph 2.4.2). in such instances, the user may type 
several answers on one line, separating each answer with a comma. 

Other answers will be explained in the relevant parts of paragraph 2, 



1.3.2 DOSGEN Batching Command Mode 

Like other system programs, DOSGEN may be used in the DOS Batching Com- 
mand Mode. In fact, some features have been added which make batching 
processing easier. These features are required for the following 
reason: For those answers whose defaults are specified in parentheses, 
DOSGEN reads teleprinter input in Image Alphanumeric Mode. Hence, it 
does not require a Carriage RETURN to complete a .READ. System con- 
siderations, however, require that Batching Mode tapes or decks be in 



lOPS ASCII. This means that each line of input must be terminated by 
a Carriage RETURN. Since lines containing one Carriage RETURN only 
cannot be generated by the Editor, the default answer must always be 
specified by a left arrow (-«-). One-character answers in teleprinter 
mode have their Batching Mode equivalents as follows: 

Teleprinter Batching 

Y Y^ 

N N^ 

$ $-> 

Carriage RETURN 

or -^ ^ 

Left- arrow {^) 

All of the above types of answers go with questions where the default 
is specified in parentheses. In any case where the default is not 
specified in parentheses (i.e., no default, or one in brackets), the 
user should have :xx. .jx^ in the batching command string. 



1.4 Error Messages 

DOSGEN checks all answers for syntax and acceptability to the DOS soft- 
ware. It also does some limited checking for acceptability within the 
current hardware configuration. Whenever DOSGEN finds a wrong answer, 
it types an error message two tabs to the right of the left hand margin 
C16 spaces in). DOSGEN does not check for multiple errors; any answers 
that follow an erroneous answer on the same line are not processed, and 
must be retyped. 

1.5 Operation 

Wh.en DOSGEN starts operation, it saves an image of the three parameter 
blocks from the system device plus the Storage Allocation Table. These 
blocks contain the old image of the three system information blocks: 
SGNBLK, SYSBLK and COMBLK. SGNBLK contains information about the de- 
fault settings of key .SCOM registers, the .DAT and .UFDT, plus an 
ordered skip chain, the names of all the handlers, and certain informa- 
tion about the devices that the system knows about. Together, SYSBLK 
and COMBLK occupy two contiguous blocks on the system device. They 
describe the system programs. Figure 1-1, SGNBLK, and Figure 1-2, 
SYSBLK and COMBLK, illustrate the contents of these information blocks. 
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Description 

Pointer to first free entry in SGNBLK 

Niimber of miscellaneo-us parameters 

Size of. DAT plus size of .UFDT = (number of 

positive .DAT slots + 161*2. (Initial value 

is 20 positive •DAT slots.) 

Number of skips in Skip Chain 

System device code CRPj?2=2j2f, RF15=15} 

Original contents of .SCOM+4 
Original contents of .SCOM+20 
Number of words per buffer (.SCOM+2 7 
Default number of buffers C.SCOM+261 
Monitor Identification Code 
Information on VT and CTRL X C.SCOM+33) 
Default files protection code (•SCOM+54) 
Size of the Resident Monitor Patch Area 
Minus the number of clock ticks in a second 
(-74 for 60 hz, -62 for 50 hz) 

Device assignments for the .DAT (made by 
handler numbers) . (Termination at 53 assumes 
20 positive slots.) 

UIC assignments for the .UFDT. (Termination 
at 111 assumes 20 positive slots •) 



Skip Chain Table (Negative skips in one's 
complements) (Termination at 137 assumes 
22 skips in chain^) 

The last part of the SGNBLK is the Device 
Handler-Skip lOT Table. Each entry starts 
with the .SIXBT representations of all 
handlers for a particular device. (First two 
characters equal device code, for all 
handlers.) Zeroes in the first six bits of 
a word indicates the end of the handler 
names, and says that the rest of the word 
contains the number of skips for this entry's 
device. The skip lOT's follow immediately. 
As above, one's complement skips indicate 
negative skips. Note, however, the confusing 
fact that a one's complement of a skip lOT 
is a positive number. Thus, 7j2fnnnn comple- 
mented is j?7nnnn. 



J SGNBLK ends at 312, in the DOS-15 system 

distributed by Digital Equipment Corporation. 



SGNBLK 



Word 


J_ 


Value 


Description 


J? 




000inn 


Pointer to first free word after SYSBLK 




; 






(There is one set of seven words/core 




7N+1 




.SIXBT^ 
.SIXBT/ 


image program. ) 




7N+2 




Name of System Program or overlay 


S 


7N+3 




nnnnnn 


Number of first block on system device 


Y 








occupied by this program or overlay 


7N+4 




j2fj?i2f|2fnn 


Number of blocks occupied by this 


S 








program or overlay 


b 


7N+5 




addres 


Thirteen-bit first address for this 








program or overlay 


L 


7N+6 




P^nnnnn 


Program size 


^ 


7N+7 




addres 


Thirteen-bit starting address for this 


' 




• 


program or overlay 


____ 




(fre 


e area) 






^jf^jJjflf 


Number of words in this entry fin this 
case, 10) 


4j?l 




.SIXBT>^ 

.sixbt/ 


Name of this system program (left- 


4jaf2 


P 


justified and zero-filled) 


1 


4^3 
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.SIXBT\ 
.SIXBT-' 


Name of an overlay (left-justified and 




4i2(4 


zero-filled) — overlays are optional 


c 


405 


g 


0j2fJJjafj2f2 


Number of buffers required by this j 


n 






system program (Bits j2f-6=0 means the 


V-/ 






end of any overlay names. This is why 


M 




i 




program and overlay names must be 


b 








left-justified. ) 


4i2(6 




.DAT&777 


Active .DAT slot 


L 


4|2f7 




.DAT&777 


Active .DAT slot (Note: 777777 for a 


K 
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.DAT slot means all positive .DAT slots.) 


41j2f 




rjZfj^pfjaj^s 


Number of words for this entry (in 






p 




this case, 5) 




411 




.SIXBTa 
.SIXBT>' 




412 


r 


Name of this system program 


413 


o S 


0i?i2fj?01 


Number of buffers required by this 




g 


^.DAT&777 


program (Note that this program has 




no overlays . ) 


414 


2 


.DAT slot for this program 


777 




0i2f040j3f 


Pointer to first word in COMBLK (equals 
count from first word in SYSBLK) . The 
two contiguous blocks on the system 
device that hold SYSBLK and COMBLK are 
treated by the system as one large 
block. In this case, COMBLK happens to 
start at location 400 of the two blocks 
combined. 



Figure 1-2 
SYSBLK and COMBLK 



Appendix D contains listings of these information blocks, as supplied 
by DEC. 

Most of DOSGEN's operations consist of building new images of SGNBLK, 
COMBLK and SYSBLK and the Storage Allocation Table. On completion 
of the last set of questions (the "H" set) , DOSGEN disallows commands 
from the teleprinter, writes out the new system block images, and de- 
letes any discarded handlers from the lOS User File Directory. (Up to 
that point, the current system had remained unchanged.) It is up to 
the user to insert added handlers and system programs. Handlers may 
be added via PIP. PATCH may be used to add core-image system programs 
for which DOSGEN has allocated space. 

2. DETAILED DESCRIPTION OF OPERATION 

This section describes the options available to the DOSGEN user, and 
explains some of the planning necessary for determining an optimum 
configuration for a particular installation. Each first order (two-digit) 
paragraph denotes a new set of questions, each second order (three- 
digit) paragraph presents an individual question and a description 
of its meaning and use. 

2.1 A. ALTER SYSTEM PARAMETERS? (N) 

The "A" section defines those system parameters that do not fall under 
I/O or system program categories. Some are default parameters which 
may be modified by commands to the Nonresident Monitor. Others may 
only be modified by DOSGEN. Figure 2-1, Section A Questions, illus- 
trates this section. 

2.1.1 API? {g)} 

This asks whether API is available on the system, and whether the user 
wishes the default to be API on or off. A "Y" response makes "API ON" 
the default condition. An "N" answer makes "API OFF" the default. 
The Nonresident Monitor's API ON/OFF command can change the state of 
API temporarily. 

2.1.2 33TTY { [^j } 

This asks which kevbn;^rd ^TC.qp-'^'^ or- t^-qp-tc;^ ■; o Tioiioii,r pTr^-;i-,Ki^ -p^,^ 
command inputs. The Resident Monitor's teleprinter handler handles 



DOSGEN VIA 

SYSTEM UPDATE ON DK0 
A, ALTER SYSTEM PARAMETERS? (N) Y 

API? (N) Y 

33TTY? (N) N 

MICtSYS] ABC 

DEFAULT # BUFFERS[3] A 

# WORDS/BUFFER [500] 525 

EXTRA 4K? (N) N 

DEFAULT FILES PROTECTION CODErS] 1 

RESIDENT PATCH AREA SIZE[0] 2500 

PAGE MODE SYSTEM? (N) Y 

60 CPS? (Y) Y 



FIGURE 2-1 



both machines with no modification. It simply needs to know which con- 
sole it is talking to. An "N" response makes the Model 35 keyboard the 
default machine. A "Y" response makes Model 33 the default. The Non- 
resident Monitor's 33TTY command can change the default temporarily. 

2.1.3 MIC [mic] 

This question prints the current Master Identification Code (MIC) in 
square brackets, A Carriage Return entry retains the old MIC. If the 
user wishes to change the current MIC, he should type exactly three 
printing characters, followed by a Carriage Return. If possible, the 
user should avoid MIC codes that equal User Identification Codes (UIC's) 
current to the system. In particular, he must avoid the following 
Urc's: ???, PAG, BNK, lOS , CTP and SCR. DOSGEN will not accept non- 
printing characters as part of an MIC. 

2.1.4 DEFAULT # BUFFERS [n] 

This command requests a default number of buffers to be allocated for 
user programs and non-core image system programs. The number in 
square brackets is the old number. If the user wishes to retain the 
old default number, he should type a Carriage Return. DOSGEN accepts 
any set of 6 or fewer octal digits followed by a Carriage Return as 
the octal number. The Master Tapes which Digital Equipment Corporation 
distributes indicate three (3) as a default number. The user must 
consider the trade off of the available core in his installation 
(systems with little memory might need a smaller number of buffers) 
versus the convenience of a large number of buffers. 

This parameter does not affect core-image system programs, which al- 
ways get as many buffers as they need. Users whose programs need a 
different number of buffers may use the BUFFS Nonresident Monitor com- 
mand to allocate the exact number of buffers needed. 

2.1.5 # WORDS/BUFFER [nnn] 

This requests the number of words per buffer, and prints the old 
number (in octal) in square brackets. A decision regarding an effi- 
cient size for the buffers requires some knowledge of the disk handlers, 
which use them. The handlers break buffers from the pool into three 

parts: (1) File Information (about 40- words) , (2) the Block List 

addresses of pre-allocated blocks (between 4 and 374g addresses, in- 
clusive), and (3) the data buffer (400g words). Thus, buffers must 
be at least 444g words long. 



The disk handlers will not use extra words in buffers longer than 103 4g. 
This, therefore, may be an upper limit on buffer size, unless other 
programs need more space in their buffers. The larger the Block List 
-^'^ that is, the larger the buffer — the faster will be output. Smaller 
Block Lists may give more efficient allocation of disk space, and will 
certainly save core. 

Any number typed will be interpreted as an octal number. 

2.1.6 EXTRA 4K? { [^j } 

For systems with an odd number of memory pages, a "Y" answer will allow 
the loaders to use the highest page in memory. For systems with no 
extra 4K page, the user should type "N" . 

2.1.7 DEFAULT FILES PROTECTION CODE [n] 

This requests the default file protection code, and prints the old 
code in square brackets. The possible codes and their meanings are: 

Code = 1 Unprotected, with the exception that the file 
may not be deleted and the number of blocks 
may not change, if the directory is protected. 

Code = 2 Write protected, if directory protected. 

Code = 3 Read/Write protected, if directory protected. 

DOSGEN will accept any one-digit octal number, but the numbers 0, 4, 5, 
6, and 7 are meaningless in this system. 

The default protection code for User File Directories is always 1, 
protected, and may not be changed by DOSGEN. 

If users wish to temporarily change the default protection they may 
use the Nonresident Monitor Command PROTECT. 

2.1.8 RESIDENT PATCH AREA SIZE [nnn] 

This requests the Resident Monitor's Patch area size and prints the 
old number in square brackets. The Resident Monitor's Patch Area is a 
number of reserved registers (no bigger than 4700 _) located just above 
the Resident Monitor. The System Loader will not refresh it, except 
on Bootstrap loads, restarts, and any of the QFILE GET commands. The 
area may be used for patching the system or for communication among 
several programs in different core loads. 

10 



DOSGEN will interpret any number typed as an octal number. The digits 
8 and 9, therefore, will not be accepted. 

2.1.9 PAGE MODE SYSTEM? ^ [^| > 

This requests the default addressing mode. A "Y" response makes page 
addressing the default mode. An "N" response makes bank the default. 
Users may temporarily change the mode via the PAGE ON/OFF or BANK 
ON/ OFF Nonresident Monibor commani-is. 

2.1.10 6jS CPS? { [^[} 

This requests the line frequency at the installation. Installations 
with 6j2fhz line frequency require a "Y" answer; those with 5j2fhz require 
an "N" response. 

2.2 B. ALTER I/O DEVICES OR HANDLERS? (N) 

This set of questions allows the user to delete or retain devices and 
all their handlers, and allows a third option of retaining the refer- 
ence to the device, and then retaining, deleting or adding handlers 
and skips for a particular device. The printout given in Figure 2-2 
illustrates the use of this section. 

Section B refers to all devices currently in the system by a two- 
character device code. The device codes for those device handlers 
included in the Master Tapes supplied by the Digital Equipment Corpora- 
tion are: 

CD Card Reader (CR0 3B or CR15) 

PR Paper Tape Reader (PC15) 

PP Paper Tape Punch (PC15) 

DT DECtape (TC15 DECtape Control) 

DK RF15 Disk Control 

DP RP15 Disk Pack Control 

LK LK35 Keyboard 

LP Line Printer (either LP15C or LP15F) 

MT MAGtape 

VP VP Point Plotting Display 

VT VT15 Graphic Display Console 

VW Writing Tablet 

(TT, which means teleprinter, is not included in this set of questions, 
because DOS uses the teleprinter as a console command device.) 

The device handler names used in Section B are printed as three-character 
names. In reality, handler names are four characters long, but this 
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B. ALTER I/O DEVICES 


OR } 


■(ANDLERS? 


J 

(N) Y 


DELETE DISCARDED 


HANDLERS? 


(Y) Y 


TO BE KEPT: 








PR? ($) $ 
PP? ($) $ 
DT? ($) $ 
DK? ($) Y 








DKB? (Y) Y 








DKC? (Y) N 








NEW HANDLERS: 








>DKD 








>DKF 








> 
DSSF=707001? 


(Y) 


Y 




NEW SKIPS: 








>■ 

DP? ($) N 








MT? ($) N 








LP? ($) $ 
CD? ($) N 








VP? ($) $ 
VT? ($) N 








VW? ($) N 








LK? ($) N 









FIGURE 2-2 
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section truncates the last character, a period {.)• The first two 
characters must be the two-character device code for the handler's 
device. The third character must be alphabetic. 

DOSGEN starts this set of questions by asking whether the user wishes 
to delete discarded handlers from lOS. Deletion saves space on the 
system device. 

DOSGEN then wegms asking key questions for each device currently on 
the system: 

XX? C$) (where XX stands for any device code) 

If the user answers with a Carriage Return or "$", DOSGEN retains the 
device and all its skips and handlers as they were in the previous 
system. If the user answers "N" , DOSGEN deletes all information about 
that device and its handlers, and all its skips from the Skip Chain. 
[Deletion of handlers from the handler UFD , lOS , does not occur until 
the termination of Section H.) 

If the user answers "Y", DOSGEN will ask specific questions about the 
handlers and skips for the device in question: 

2.2.1 XXX? (Y) 

(where XXX stands for any handler name) 

DOSGEN asks this question for each handler the device has in lOS . A 
"^Y" response retains the handler; an "N" response deletes it. 

NOTE: DOSGEN does not allow the user to delete the "A" 
handler for the system device (DKA. or DPA.). 

2.2.2 NEW HANDLERS: 

When DOSGEN has asked a question for each of the device's handlers cur- 
rently in lOS, it asks whether the user wishes to add any new handlers. 
It makes no sense to "add" a handler name which has just been deleted. 
If the user wishes to change a handler, he may use PIP to transfer a 
new one to lOS . PIP will automatically delete the old one if the user 
transfers a new one with the same name . New handler names should fol- 
low the rules outlined in paragraph 2.2. Whenever the user has no more 
handlers to add, he should simply type a Carriage Return. 



Adding handler names only makes them "logically" present. The user 
must call PIP to transfer the handlers to the lOS UFD, in order to make 
handlers physically present. DOSGEN warns the user about missing 
handlers at the end of Section C. File names for handlers in lOS must 
have the same name as the handler global and a "BIN" extension 
(e.g. , DKA.BIN) . 

2.2.3 (Old skips) 

Presumably, the user changes old skips only in the case where they were 
incorrectly inserted. In any case, after the user has indicated he has 
no more handlers to add for the current device, DOSGEN prints the skips 
for this device that are in SGNBLK (whether or not these skips are in 
the skip chain) . DOSGEN prints skips in the following format: 

devskp = nnnnnn? (Y) 

A Carriage RETURN or "Y" accepts the old skip; an "N" deletes the skip. 

2.2.4 NEW SKIPS: 

When DOSGEN has exhausted the skips for the current device as they were 
in the old system, it requests any new skips. New skips should be 
typed in the following format: 

devskp = nnnnnn 

where devskp has no more than six characters, and nnnnnn starts with 
octal 70. DOSGEN rejects all other formats and repeats the ">" symbol 
which requests another skip. 

When the user types a Carriage RETURN after the ">", DOSGEN proceeds to 
the next device. Negative skips (that is, those which skip on "OFF", 
not "ON") should be preceded by a minus sign (-) , to indicate that they 
are negative: 

devskp = -nnnnnn 

2.3 C. ADD NEW DEVICE? (N) 

When DOSGEN has finished with Section B, it asks whether the user 
wishes to add a new device. Section C differs from other sections in 
that restarts (CTRL P) only delete information added for the current 
device. 

That is, if the user adds devices AA, BB, and CC, but types CTRL P 
during the CC operation, DOSGEN will return to a point just after the 
completion of the BB device insertion. 
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VThen the user has no more devices to add — that is, when he answers 
the key question with an "N" or Carriage Return, DOSGEN will remind 
him of all the handlers he has added to the system, but which are not 
yet present in lOS . He can add them later, via PIP. The printout of 
Figure 2-3 illustrates the use of this Section. 

2.3.1 DEVICE CODE [ ] 

Here, the user may type any two alphameric characters that DOSGEN can- 
not interpret as an octal number. It is recommended, however, that 
the user give only alphabetic characters, as any numerals might be con- 
fused with a unit number. DOSGEN will not accept any input other than 
two alphameric characters. There is no default for this question — 
that is, DOSGEN assumes that, if the user answered the Section C ques- 
tion with a "Y", then he has a device code to add. DOSGEN makes no 
assumption about which device it is. 

2.3.2 NEW HANDLERS: 

Here, the user should add all the handlers he will use for the new de- 
vice. The names should follow the rules for handler names outlined in 
paragraph 2.2 with the exception that the user must not type the final 
period (. ) . 

The new skips for the device should follow the format outlined in 
Paragraph 2.2.4. DOSGEN adds all new skips to the end of the Skip 
Chain. The user may change the order of the Skip Chain in Section D. 

When the user has no more skips to add, DOSGEN repeats the key question 
for Section C, 

ADD NEW DEVICE? (N) 

If the user has another new device, he may add it now. 

2.4 D. CHANGE SKIP CHAIN? (N) 

When the user has responded iD the key question for Section C with an 
"N" or a Carriage Return, DOSGEN proceeds to Section D, which allows 
the user to change the Skip Chain order and delete skips. The user may 
not add any skips in this section. The printout of Figure 2-4 illus- 
trates the user of this Section. 
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C, ADD NEW DEVICE? (N) Y 
DEVICE CODE[ ] AD 
NEW HANDLERS? 
>ADA 

> 

NEW SKIPS: 

>705432 

("705432" ISN'T SYMBOL) 
>ADSKP=705432 

>ADON=705332 

>ADOFFr702345 



C. ADD NEW DEVICE? (N) N 

MISSING HANDLERS: 

DKD. 

DKF. 

ADA. 



FIGURE 2-3 
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<: 

D. CHANGE SKIP 


CHAINi 


* (N) Y 




SKIP MNEMONICS IN ORDER: 


DISPLAY 


SKIP 


CHAIN? 


(Y) ^ 


>ADSKP 


DEFAULT 


SKIP 


CHAIN 


DRDER: 


>$ SPFAL 


SPFAL 
DTDF 








>$DTDF 


DSSF 
DPSJ 








>ADON 


MTSF 
SPDI 








>SDSSF 


WTSK 
SDDF 








>$DPSJ 


RCSF 
PCSD 








>ADOFF 


CLSF 

LSDF 








>$MTSF 


PSF 
PSF 








>$SPDI 


KSF 
SPKF 








>$WTSK 


TSF 
DTEF 








>$SDDF 


DPSE 
MPSNE 








>$RCSF 


!*!PSK 
SPE 








>$PCSD 


ADOFF 
ADON 








>$CLSF 


ADSKP 








>$LSDF 

>$RSF 

>$PSF 


(continued 


at right) 


>$KSF 










>$SPKF 










>$TSF 










>$DTEF 










>$DPSE 










>$MPSNE 










>$MPSK 










>$SPE 


. ■ _ 








>$ 








FIGURE 


2-4 
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2.4.1 DISPLAY SKIP CHAIN? (Y) 

In most instances, the user will wish to see all skip mnemonics and 
acronyms in the old system, plus those he has just added. If he 
answers "Y" or Carriage Return, DOSGEN types: DEFAULT SKIP CHAIN 
ORDER, followed by the old Skip Chain with new skips at the end. 

2.4.2 SKIP MNEMONICS IN ORDER: 

Users have two basic options for this part: (1) accept the whole chain 
as is, or retype the entire chain, in a new order. The user may type 
a single Carriage RETURN in response to the "SKIP MNEMONICS IN ORDER:" 
question, and obtain the old chain order, with any new skips at the 
end of the chain. If he types any mnemonic, however, he must account 
for all of the skips. When the user responds to DOSGEN 's request for 
the next skip (> ) with an ALT MODE, DOSGEN types "$" and the first 
skip in the old chain that has not already been selected. When the 
user responds to the ">" with a Carriage RETURN, DOSGEN deletes all 
unlisted skips, freezes the new order, and continues on to Section F. 

Two warnings are in order: (1) Negative skips should be at the end of 
the chain. Illegal interrupts may otherwise occur when the peripheral 
device is down. (No standard DOS devices have negative skips.) 
(2) Beware of changing the relative order of the chain, as supplied 
by DEC. For instance, the clock interrupt must come before the printer. 

2.5 E. ALTER DEVICE PARAMETERS? (N) 

2.5.1 7 CHANNEL MAGTAPE { |^b 

The user should choose the proper default. "N" gives 9-channel. 

2.5.2 LINE PRINTER SIZE (80, \2^ , OR 132) [nnn] 

Acceptable responses to this question are SjZf, 12J?, or 132, or a Carriage 
Return. A Carriage Return will retain the old line size, printed in 
square brackets. 

2.5.3 VT ON: ( f^j } 

This requests the default setting for the CTRL X option. A "Y" makes 
VT ON the default. An "N" makes VT OFF the default. DOSGEN does not 
ask this question or the next one if the VT is not on the system. 

2.5.4 HALF ON? { i^J } 

(N) 

This requests the default setting for the half-screen setting for the 

.» v^t-u-j-wxi. rill iM j-tsajjunsfc: iucijs.es nAjji;- uii?' tne detault. A "Y" 

response makes HALF ON the default. 
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E. ALTEP DEVICE PAPAMETERS? CN) Y 
7 CHANNEL MAGTAPE? (Y) N 

LINE PRINTER LINE SIZE(80,120, OR 132)[80] 120 
VT ON? (N) ♦- 
HALF ON? (N) Y 

FIGURE 2.5 



F. ALTER .DAT SLOTS? (N) Y 

# OF POSITIVE ,DAT SLOTS[20] 15 
DISPLAY .DAT SLOTS? (Y) Y 



• DAT 


DEVICE 


UIC 


-15 


DKA 


UIC 


-14 


DKA 


UIC 


-13 


DKA 


UIC 


-12 


TTA 


UIC 


-11 


DKA 


UIC 


-10 


TTA 


UIC 


-7 


DKL 


SYS 


-6 


DKA 


UIC 


-5 


NONE 


UIC 


-4 


DKA 


UIC 


-3 


TTA 


UIC 


-2 


TTA 


UIC 


-1 


DKA 


SYS 


1 


DKA 


UIC 


2 


DKA 


UIC 


3 


DKA 


UIC 


4 


TTA 


UIC 


5 


PRA 


UIC 


6 


PPA 


UIC 


7 


DTAl 


UIC 


10 


DTA2 


UIC 


11 


NONE 


UIC 


12 


NONE 


UIC 


13 


NONE 


UIC 


14 


NONE 


UIC 


15 


NONE 


UIC 



NEW ASSIGNMENTS: 

>A AD 11,12,13,14,15 

>A <APC> 1/CDE\\\<CDE> 2 



FIGURE 2-6 
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2.6 F. ALTER .DAT SLOTS? (N) 

This section allows the user to alter the number of .DAT slots, which 
is a permanent change to the system (until the next System Generation) , 
and to make the default assignments to both the .DAT slots and the 
.UFDT slots. The operator may temporarily change the assignments via 
the ASSIGN (A) command to the Nonresident Monitor. (See Figure 2-6.) 

2.6.1 # OF POSITIVE .DAT SLOTS Inn] 

This asks the number of positive .DAT slots for the new system, and 
indicates the old n\imber in square brackets . The number of negative 
.DAT slots is fixed at fifteen (15) . DOSGEN will accept any octal 
number from 1 to 77, inclusive. Each .DAT slot adds two registers to 
the size of the Resident Monitor and two parameters to SGNBLK — one 
for the .DAT slot entry, and one for the .UFDT entry,. Users with a 
great deal of core should still be careful about too many .DAT slots. 
That might cause SGNBLK overflow and an abort from the system genera- 
tion. Further, OTS users must reassemble FIOPS and .FLTB in order to 
use more than 20 .DAT slots. See Appendix C. 

2.6.2 DISPLAY .DAT SLOTS (Y) 

If the user wishes to change any assignments, he may request their 
current assignments by answering "Y" or Carriage Return. This has the 
effect. of a REQUEST command to the Nonresident Monitor. 

2.6.3 NEW ASSIGNMENTS: 

The user may make new default assignments to the .DAT and/or .UFDT by 
using the same ASSIGN (A) commands he would use to the Nonresident 
Monitor. When the user has no more new assignments, he should type 
Carriage Return when DOSGEN types a new angle bracket (>) . UIC in a 
.UFDT slot means the UIC currently logged in will be given to that 
.UFDT slot. SYS in a .UFDT slot m.eans either BNK or PAG will be 
assigned to that slot by the loaders (depending on the addressing mode 
of the load) . Any other three letters will be retained unless 
changed via an ASSIGN command. 

2.7 G. CHANGE SYS FILES? (N) 

With the exception of the first question, which refers to the size of 
the tQAREA, this section refers to the core-image system programs cur- 
rently listed in SYSBLK and COMBLK. This section allows no additions. 
The printout given in Figure 2-7 illustrates the use of this section. 
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G. CHANGE SYS FILES? (N) Y 

tQ AREA SIZE(NONE,16K,20K,24K,28K,32K)[32K1 1 6K 
TO BE KEPT: 

D0S15? ($) $ 
EDIT? ($) N 

EDITVP? ($) $ 
EDITVT? ($) N 

PIP? ($) $ 
MACRO? ($) $ 
CHAIN? ($) $ 
F4? ($) $ 
DUMP? ($) $ 
DTCOPY? ($) $ 
PATCH? ($) $ 
UPDATE? ($) $ 
SRCCOM? ($) N 

8TRAN? ($> N 

89TRAN? ($) N 

MTDUMP? ($) N 

QFILE? ($) $ 
SGEN? ($) $ 
TKP? ($) $ 



FIGURE 2-7 
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2.7.1 fQ AREA SIZE (NONE, 16K, 2j2fK, 24K, 28K, 32K) [nn] 

DOSGEN does not ask this question for Disk Pack systems — they always 
receive 32K. 

This question allows the DECdisk user to set the tQ AREA size. Users 
with an RF disk system device may wish to delete the fQ AREA. In that 
case, they should type NONE, in response to this question. The Resi- 
dent Monitor will not allow dumps to a iQ AREA on the RF disk that is 
smaller than the current core size, or to a nenexistent area. The 
user should therefore avoid having an area which is smaller than his 
core size — it would simply waste space. "i^" must follow the numbers 
16, 2j2f, 24, 28, or 32. 

Should the user need to make the tQ AREA larger, DOSGEN must try to 
find enough contiguous free blocks to hold the new one. If this proves 
impossible,, special steps may need to be taken. Refer to paragraph 
2.7.2.2 for those steps. 

2.7.2 TO BE KEPT : 
syspro? ($) 

After the tQ AREA size has been defined, DOSGEN asks questions about 
each core-image system program currently on the system, in the order 
that it finds them in COMBLK. A response of "$" or Carriage Return 
instructs DOSGEN to- retain all information about the last-named system 
program. A response of "Y" instructs DOSGEN to retain the program's 
name in SYSBLK and COMBLK, but implies that the user wishes to change 
some of the information about the program, as listed in SYSBLK and 
COMBLK. An "N" will delete the program from the system. DOSGEN will 
not allow D0S15 to be deleted. 

2.7.2.1 ovrlay (Y) (where 'ovrlay" is the name of any cur- 

rently listed overlay) 

If the user responds to a system program name with a "Y" , DOSGEN first 
lists each of the program's overlays, if any. These are Yes/No answers 

A "Y" or Carriage Return response retains that overlay, and an "N" 
response deletes it. 
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2.7.2.2 OVERLAY NAME [] 

If the user wishes to add any overlays to the current system program, 
he should type the names at this point. DOSGEN will reject names which 
are more than six characters long, or are the same as any Nonresident 
Monitor or PATCH command. If the named overlay is already listed in 
SYSBLK, DOSGEN will request the next overlay. If not, DOSGEN will re- 



# OF BLOCKS [] 

The user should type the number of blocks the new system program will 
occupy. If the number is legal, DOSGEN tests whether there are as 
many contiguous free blocks on the system device as are necessary 
to hold the new overlay. DOSGEN starts testing at block J? of the 
system device, and stops as soon as it finds enough blocks. DOSGEN 
then updates its image of the Storage Allocation Table (SAT) to 
indicate that those blocks are occupied. 



Note that when disk space is tight, and the user wishes to add several 
system programs and overlays, DOSGEN may not allocate disk space effi- 
ciently. In an extreme case, the user may need to first transfer the 
BNK and PAG UFD ' s (or even all of lOS , except the system device's "A" 
handler) off the disk via PIP, and then do one pass through DOSGEN to 
delete all unwanted system programs. Then the user must do enough suc- 
ceeding passes to ensure that system programs are added in order of 
size, with the largest first. Finally, the user should transfer the 
BNK and PAG UFD's back, via PIP. This allows the UFD files, which 
need not be in contiguous blocks, to use up the noncontiguous blocks. 

Ordinarily, the procedure outlined in Chapter 3 should be sufficient 
to free all necessary disk space. NOTE ; New overlays or system pro- 
grams must run in Bank Mode. Use CHAIN for Page Mode programs. 

2.7.2.3 BUFFS [nn] 

This question indicates the number of buffers previously allocated 
for this system program, and asks whether the user wishes to change 
L-iiG num^jer. DOSGEN does not check whether the number of buffers al- 
located is compatible with the program. That is the user's responsi- 
bility. 
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2.7.2.4 .DAT SLOT nn? (Y) 

After the user has indicated the number of buffers for this program, 
DOSGEN asks him to check the .DAT slots required. It first lists the 
old ones. If the user types Y or Carriage Return, DOSGEN retains the 
listed .DAT slot. An "N" deletes the listed .DAT slot. 

2.7.2.5 .DAT SLOTS 

After checking the old .DAT slots, the user should add any new ones 
the program needs. The .DAT slots added must be legal, as determined 
in Section F. All positive .DAT slots may be obtained by typing 
"ALL ". If the user has added an overlay, he should add any .DAT slots 
needed by the overlay but not listed by DOSGEN for the system program. 



2.8 H. ADD SYS PROG? (N) 

This section allows users to add the names of new core-image system 
programs and their overlays to SYSBLK and COMBLK. Restarts in this 
section delete only the current system program, just as they do for 
new devices, Section C. 

The printout given in Figure 2-8 illustrates the use of this section. 

2.8.1 PROG NAME [] 

Names must conform to the rules for system program names outlined in 
paragraph 2.7.2.2. There is no default for this question. 

2.8.2 # OF BLOCKS [] 

This question works just like that for overlays, described in paragraph 
2.7.2.2. There is no default for this question. 

2.8.3 OVERLAY NAME [ ] 

Any overlay names must conform to the rules for system program names 
outlined in Paragraph 2.7.2.2. If the overlay name is not already 
listed in SYSBLK, DOSGEN requests: 

# OF BLOCKS [ ] 
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H. ADD SYS PROG? (N; Y 

PPOG NAME[ ] ADMON 

# OF BLOCKSt 3 7 
OVERLAY NAME[ ] ADMON 1 

# OF BLOCKSt ] 3 

OVERLAY NAME[ 3 

PUFFS[0 3 4 
C 

.DAT SLOTS: 
>11,12,13,I4,15 

> 

H, ADD SYS PROG? (N) N 



MODIFYING SYSTEM(tP,tC IGNORED) 



DELETED HANDLERS: 

DKC, 

DPA, 

DPB. 

DPC. 

MTA, 

MTC, 

MTF, 

CDB. 

VTA. 

VWA, 

LKA. 

SGEN COMPLETE 



FIGURE 2-8 
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2.8.4 BUFFS [0] 

The user should enter the octal number of buffers needed for the new 
system program. 

2.8.5 . DAT SLOTS : 

The user should list the octal numbers af all .DAT slots needed by the 
new system program, or any of its overlays. The response "ALL^" obtains 
all positive .DAT slots. 

After the user has entered all necessary .DAT slots, he should type a 
Carriage Return in response to the "> " symbol typed by DOSGEN. This 
returns him to the start of Section H. 

If the user types Carriage Return or "N" to the key question for 
Section H, DOSGEN disallows CTRL P or CTRL C, modifies the system, 
and returns to the monitor. At this point, the user must do a 
Bootstrap restart, in order to bring in the modified system. 

3. DOSGEN AND ITS CONTEXT 



3. 1 Building DOS- 15 for the First Time 

Digital Equipment Corporation supplies DOS-15 on disk restore tapes — 
either one 7- or 9-track magnetic tape, or two DECtapes. In addition, 
users with optional Floating Point Hardware should obtain a tape with 
the Floating Point FORTRAN and Object Time Systems to accommodate that 
option. The disk restore tape(s) should be copied onto the system 
device via the DOSSAV program. Appendix A describes DOSSAV operation. 

After the completion of a DOSSAV run from the DEC restore tapes to the 
system device (disk) , the disk will contain: 

1. A working DOS-15 system 

2. Completed images of three system information blocks: 

SGNBLK, SYSBLK, and COMBLK. 

3. Core-image files of the following system programs: 

D0S15, the Nonresident Monitor 
RESMON, the Resident Monitor. 
.SYSLD, the System Loader 
EDIT 
EDITVP 
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EDITVT 

PIP 

QFILE 

MACRO 

CREF, MACRO'S overlay for pass three 

CHAIN 

FA, the FORTRAN program for PDP-15 machines without 
floating point hardware 

DUMP 

DTCOPY 

PATCH 

UPDATE 

SRCCOM 

8TRAN 

89TRAN 

MTDUMP 

DOS GEN 

TKB, the task builder for PDP-15 RSX 
The DOS-15 User's Manual, DEC- 15-MRDA-D, gives brief descrip- 
tions of all these system programs, except TKB, the RSX Task 
Builder. See DEC-15-GRQA-D for information on TKB. 

4. Relocatable binary files in the lOS UFD. These files are 
handlers for the following devices: 

RF15 DECdisk Control 

RP15 Disk Pack Control 

PC15 High-Speed Paper Tape Reader and Punch Control 

VP15 Point Plotting Display 

VT15 Graphic Display Processor 

TC59 Magnetic Tape Control 

LP15C and LP15F Line Printers 

LK35 Keyboard 

TC15 DECtape Control 

CRj2(3B Card Reader Control 

VWj2fl Writing Tablet 

Appendix B contains a listing of lOS , as supplied by the 
Digital Equipment Corporation. 

5. Relocatable binary files in the BNK and PAG UFD's. These 
files are the relocatable system programs: EXECUTE, .LOAD, 
FOCAL, and DDT, plus .LIBR, the system library. They load in 
Bank and Page Mode systems, respectively. Appendix B con- 
tains a listing of the BNK and PAG UFD's as supplied by DEC. 
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Several source and binary files in the PER UFD. These files 
are for optional peripherals not included in the majority of 
the systems DOS-15 will serve, and for PDP-9 owners who wish 
to use DOS-15. Appendix C lists the PER UFD, as supplied by 
DEC, and describes the use of the routines contained in PER. 
A 32K CTRL Q Area. 
SCR, the default UFD. SCR will be empty. 



The above-mentioned files and information blocks will fit on the 
smallest system device supported by DOS-15, a single-platter RF15 
DECdisk. Part of the system generation process is designed to free 
the system device blocks occupied by unneeded handlers and system 
programs. This is especially important on one- or two-platter DECdisk 
systems to which the user intends to add his own system programs. The 
following procedure will free up disk storage and set up a new system 
in an orderly fashion: 

NOTE 
The user should be logged in under the Monitor 
Identification Code for all the following 
operations. 

3.1.1 Preliminary DOSGEN Run 

Call DOSGEN, set up the correct system parameters, and delete all un- 
desired device handlers and system programs. Do not add any new 
handlers or programs. If a DECdisk system, and the computer's main 
memory holds less than 32K words, reduce the CTRL Q Area. 

3.1.2 One Mode Addressing 

Users who intend to have a Bank or Page mode system only should delete 
the appropriate UFD: 



^^%^ ^<pag;'. 

\ppj \<BNK>/ ^^^^ 



>N 



3.1.3 FORTRAN Considerations 

The user should next consider the system's FORTRAN capabilities. PDP-9 
users should call PATCH, and replace F4 supplied with the system with 
the binary file, F4X9, supplied in the PER UFD: 

$A (?F) <PER>-lCiJ/ 

$PATCH^ 

> 



RE ADR F4X9^ 
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>EXIT^ 



PDP-15 users whose systems have the Floating Point Hardware should re- 
place the system libraries in BNK and PAG with the libraries found in 
the extra FORTRAN Floating Point Tape. Before doing so, however, 
the system manager should consider whether FOCAL will be used at the 
installation. If so, he must make an Execute file out of FOCAL. 
(FOCAL has not been modified to take advantage of Floating Point Hard- 
ware, and uses non-Floating Point OTS routines.) If the user has his 
own FOCAL routines, he should add them to FNEW (see Appendix C) . 

$PAGE ON or OFF, as desired 

$A SYS -4/Cassign desired output UIC) 

$CHAIN 

>FOCAL ALT MODE 
>ALT MODE 
> FOCAL ALT. MODE 
>ALT MODE ALT MODE 

Then the system manager should replace the standard library with the 
Floating Point Library: 

$PIP 

^^/<DK>•^ /BNK .LIBR BIN^DTl BLIBRF BIN^ 
V<DP>/XPAG .LIBR BIN^DTl PLIBRF BIN/ 

Users with PDP-15 Floating Point Hardware should then replace the 
FORTRAN supplied as a system program with the one from the Floating 
Point Tape : 

$A DTI -IjHj 

$PATCH^ 

>Fi) 

>READR FPF4X^ 

>EXIT^ 

3.14 Graphics 

When the proper FORTRAN routines have been installed, the user with a 
VT15 Graphics Display Processor should add the Graphics routines in 
the PER UFD to the system libraries in BNK and PAG: 
?A(°K)p,, -WOCI^^:) -14,-15^ 

$ UPDATE^ 
>US^^ 

>I ROTATE J 
>I CIRCLE 5 
>I VTPRIM? 
>I DYLDRJ 
>I TRACK/ 
>I LTORPBi^ 
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3.1.5 VP15 Point Plotting Display 

The user with a VP15 Point Plotting Display should add the following 
routines to the libraries: 

/DK\ ^„^„^ , ri //DK\ ''<PAGn 



5A (-}<PER> -W{°^CbNkD-1^' -is; 



$UPDATE^ 

>I VECTOR^ 
>I FORT^ 

>i nuvalJ 

3.1.6 Source Files in PER 

The user should next decide whether he needs any of the source files 
supplied in PER. If so, he should assemble them via MACRO-15. 
Appendix C describes the assembly parameters relevant to all the 
source files in PER. Appendix C will also describe where in the system 
the assembled files should be inserted. 

3.1.7 Second DOS GEN Run 

The user should run through DOSGEN, to add any devices and system 
programs needed for the system. 

3.1.8 PATCH 

The user should call PATCH, to add any system programs for which 
DOSGEN has reserved space. 

3.1.9 PIP 

the system. * The user should then save the PER UFD on a tape, for 
future reference, and delete the PER UFD from the system. 

3.1.10 Copy the System 

Finally, the user should make at least one copy of the new system, 
via the DOSSAV program. 



* Once device handlers have been transferred to lOS, they must be 
renamed, if necessary, to the names assigned in Sections B and C, 
The PIP "R" command will rename files. 
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3.2 Using DOS GEN After the First Time 

The system manager may call DOSGEN at any time, in order to modify 
the system. Changes in system parameters, and deletion of devices, 
device handlers or system programs require no advance preparation. 
Addition of core-image system programs, however, may require some 
preliminary work with PIP. 

Core image system programs must occupy contiguous blocks on the system 
device. In a running system, it is quite possible for there to be 
sufficient free blocks to accept a new core image file, but no set of 
contiguous, free blocks. In such an instance, the user will have to 
transfer files from any of the UFD's on the system device to another 
mass storage medium, and then run DOSGEN. After the DOSGEN run, 
PATCH can add the system files, and PIP can bring back the transferred 
UFD's. UFD's need not have contiguous disk storage. 
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APPENDIX A 
DOSSAV Operating Instructions 

DOSSAV is the save/restore system for DOS-15. It resides on a paper 
tape, which must be HRM loaded at 37720 (restart 34500) . 

It saves and restores to/from DECdisk, Disk Packs, DECtape and Magtape. 
A DECdisk system can be saved on and restored from DECtape, Magtape 
and Disk Pack. A Disk Pack system can use DECtape and Magtape. 

Once loaded, it asks for all necessary information, such as input and 
output devices, unit numbers and, in the case of Magtape, parity and 
density. 

GENERAL INSTRUCTION: 

The user must type Carriage Return after all entries, including the 
character typed to restart after errors. 

^ • Resto ring Systems 

The following examples illustrate how to put the systems distributed 
by Digital on DECtape or Magtape onto a DECdisk or Disk Pack. The user 
responses are underlined. 



1. To restore a DECdisk system from DECtape (on Unit 1) 



DOSSAV Vnn 
INPUT DEVICE? 
UNIT NO? 1^ 
OUTPUT DEVICE? 
DATE CREATED: 



DT p 



DKp 
28-SEP-71 



TAPE DONE. MOUNT ANOTHER 



/Note that if DK is typed no 

/unit number is requested. 

/At this point, mount tape 2 and 

/type any character on the key- 

/board followed by a Carriage 

/RETURN. 
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2. To restore a DECdisk system from Magtape (on Unit 

DOSSAV Vnn 
INPUT DEVICE? MT^ 
UNIT NO? IP ~~"^ 
TRACK (7 OR 9)? 7^ 
DENSITY (2,5,8)? &) 
PARITY (E OR O) ? Oj 
OUTPUT DEVICE: DkJ 
DATE CREATED: 2 8-SEP-71 



NOTE 

All DOS-15 System Restore Magtapes distributed 
by Digital are 80i? BPI, odd parity. 

3. To restore a Disk Pack system from DECtape (on Unit 1) : 

DOSSAV Vnn 

INPUT DEVICE? DT } 

UNIT NO? Ij 

OUTPUT DEVICE? DP ) 

UNIT NO? 0^ t 

DATE CREATED: 2 8-SEP-71 

TAPE DONE, MOUNT ANOTHER At this point, mount Tape 2 and 

type any character on the tele- 
printer followed by a Carriage 
RETURN . 

4. To restore a Disk Pack: 

DOSSAV Vnn 

INPUT DEVICE? MT_^ 

UNIT NO? U 

TRACK (7 OR 9)? j) 

DENSITY (2,5,8)? 8 J) 

PARITY ( OR O)? o5 • 

OUTPUT DEVICE? DP"!- 

UNIT NO? ^) 

DATE CREATED: 2 8- SEP- 71 

It is possible to restore a software system to the DECdisk which was 
created for a machine smaller (different number of DECdisk platters) 
than the one being restored to. DOSSAV does all the necessary adjust- 
ments of the SAT's^: Therefore, the restore tapes issued by Digital 
for a 1 platter system can be restored to any system. Note that this 
should only be done with the master tape(s) which have block 1775 
free. That block is needed during the restore for 5 or more DECdisk 
platters. Note that it is not possible to restore a software system 
which is larger than the hardware. (For example, one cannot restore 
a 3-platter system onto a 1-platter configuration. 



^ SAT ' s : Storage Allocation Tables - i.e., bit 



maps 
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B. Savi na ^vst-f^mc; 



Once the user has tailored the system to his specific configuration, 
he will want to save that system for future restorations. To do that, 
simply reverse the procedure above. To illustrate, consider Example 1 
above and the changes necessary to it to create a restore tape. 



To save a DECdisk system to DECtape (on Unit 1) : 

DOSSAV Vnn 

INPUT DEVICE? DKj 

OUTPUT DEVICE? DT J 

UNIT NO.? IJ 

TAPE DONE. MOUNT ANOTHER 



At this point, mount another tape 
and type any character on the key- 
board followed by a Carriage 
RETURN. 



Note that DOSSAV allows for as many DECtapes and Magtapes as are 
necessary to hold the system. 

C. Error Conditions and Messages 

Recoverable errors during command string decoding: If a question is 
answered incorrectly, DOSSAV outputs an appropriate error message and 
then repeats the question. These error messages are: 



ILLEGAL DEVICE 

BAD TRACK 
BAD DENSITY 

BAD PARITY 



An illegal device mnemonic was 
typed (something other than DP, DK, 
DT or MT) or an illegal combination 
of devices was typed (i.e., input= 
DT and output = MT) . 

Something other than 7 or 9 was 
typed . 

Something other than 2 (200) , 
5 (556), or 8 C800) was typed. 

Something other than E(even) or 
(odd) was typed. 



Recoverable errors during operations: If it is possible to recover 
from an error, DOSSAV will attempt to do it. The error message will 
be output to the console. After the problem has been corrected, any 
character on the keyboard followed by a Carriage RETURN will resume 
operation. 

TAPE NOT READY 



DISK NOT READY 
DISK PACK NOT READY 



The DECtape or Magtape unit is off 

DECdisk is write locked. 

The Disk Pack unit is not ready. 
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Unrecoverable errors: Primarily hardware errors, from which DOSSAV 
cannot recover. After the error message has been output, DOSSAV 
restarts. DOSSAV retries five times on parity error, before issuing an 
unrecoverable error message. 

DECTAPE ERROR 

MAGTAPE ERROR 

DISK ERROR 

DISK PACK ERROR 

ATTEMPT TO RESTORE SYSTEM To protect users who have access to 
TO WRONG DISK both a DECdisk and a disk pack and 

who may have several sets of 
restore tapes, all restore tapes 
are created with the mnemonic of 
the disk type in the first SAT. 
DOSSAV then checks this code against 
the output device code. If they 
differ, this message is output. 

BLK 1775 OCCUPIED. NO 2ND SAT CREATED 

A DECdisk system created for 4 or 
fewer platters is restored to a 
machine with 5 or more platters 
and block 1775 is already used. 
Therefore, no second SAT is created. 
A Master Tape was not used to make 
the restore. 

D. Tape Structure 

The restore tapes are structured as follows: The first SAT of the 
system is the first block put on the tape. This SAT, which is never 
restored to the disk, has 2 words modified: word 2 contains the 
creation date (taken from .SCOM+47) and word 376 contains the device 
mnemonic (.SIXBT, right justified). All the occupied blocks referenced 
by this SAT are then put sequentially on the tape. The second SAT, if 
there is one, is then put on, and so on. This structure enables use of 
Magtape, which is a sequential only device. 



DOSSAV Restrictions 



1. It is not possible to save or restore Magtapes with even 
parity. 

2. DOSSAV fails when two DECtapes are on line with the same 
unit num.ber. It is necessary to restart under such 
circumstances . 

3. Error checking and recovery is minimal. 
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APPENDIX B 



lb-UCT-71 
OIRtCTUrtY LISTING (BNK) 

2(^12 f-Rte buKb 

5 UStR FRtS 

I0*fl USt>< dLKS 

EXfcCuT biN i 24-SEP-71 

.LI0'< BIN li^ft 24-StP-7l 

.LOAD BIN 11 i(56-QCT-7l 

FQCAl eIN 23 24-5CP-71 

OCT BIN 13 24-SEP-71 



15-0CT-71 
OIRtCTOHY HSriNb CPAt) 
2^12 FRLt BLK5 
D UStW ULES 
IbiO ubtK BLKS 
EXECUT BIN 3 24-SEP-;i 

,LIbR BIN IkJb 24-SEP-71 

,LOAO biN 11 i>i6-0CT-7l 

FUCAL tlfi 23 24-SEP-71 

DOT BIN 13 24-StP-7l 



15-QCT-71 






MFD OIRECTQWY LISTLMG 




2^312 f-REE bL«S 






05 UStR FiLtS 






l^i)A uSt« bLKS 






BNK 54(1) 


5 


160 


PAG 3i/l2Cn 


5 


I6fe! 


lOS 277Cn 


31 


221 


SCR NUNfidl 


^ 


M 


PER 53(1) 


i^l 


271 
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APPENDIX C 



The following is a listing of the PER UFD; 



28-.SEP-" 


M 






DIRECTORY LTSTIN 


IS 


fPER5 


!5 


FREE 


BLK! 






21 


USER 


FILES 




271 


USER 


BLKS 






OOSRCO 


i03 




37 


28-SEP-71 


CD. DOS 


|?112 




52 


28-SEP-71 


FNEW 


0C;4 




16 


28-SEP-71 


LPA.IS 


942 




31 


2IS«-SEP»71 


OVLDR 


BIN 




2 


28-SEP-71 


TRACK 


BIN 




2 


gS-SEP-.7l 


VTPRXM 


BIN 




7 


2«.SEP'-71 


ROTATE 


BIN 




2 


29-SEP-71 


MIIVAL 


BIN 




1 


2S-SEP-71 


FORT 


BIN 




1 


28-SEP-71 


VECTOR 


BIN 




3 


28-SEP'71 


CIRCLE 


BIN 




2 


2fl-SEP-7l 


LPA.09 


BIN 




3 


28-SEP-71 


F4X9 


BIN 




52 


2fl-SEP-7l 


VPA.S 


BIN 




4 


28.$EP-7l 


LP. 647 


BIN 




3 


28-SEP-71 


LTORPR 


BIN 




I 


28-SEP-71 



PER contains four source files 



DOSBCD j2f^3 
CD. DOS J2fj2f4 
FNEW j2f|?4 
LPA.15 j2f42 



Those installations which have their own FOCAL routines may want to 
use EDIT's GET command to add their sources for FNEW. If these 
sources substitute for others already present, EDIT can delete the 
old routines. Once FNEW is completed, MACRO will produce FNEW BIN. 
Then, the following commands to UPDATE will delete the old FNEW, and 
insert the new one: 
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Table C-1, Assembly Parameters for Handler Sources in PER UFD, shows 
the assembly parameters that will produce all the possible variations 
of binary files. Note that once assembled, programs put in the lOS 
UFD must be renamed. For example, the binary produced from assembling 
LPA.15 042 is LPS. 15 BIN. When this program is put in the lOS UFD, it 
must be renamed to LPA. BIN. 

TABLE C-1 
ASSEMBLY PARAMETERS 



Binary Produced Source Name 

LPA. (form feed on 
.INIT's, . CLOSES 's 
& every 57,Qlines) LPA.15 042 

LPA. (form feed on 

.INIT & every 57^^ lines) LPA.15 042 



Assembly Parameters 



none 



N0FF=1 



LPA. (tab stop=8) 
LPA. (tab stop=10) 



LP. 64 7 002 
LP. 647 002 



none 
TAB 10=0 



CDB. (CRO3B,029 mode) 

CDB. (CRO3B,026 mode) 

CDB. (CR15,029 mode) 

CDB. (CR15,026 mode) 



CDB. (CR01E,CR02B, 

029 mode) 
CDB. (CR01E,CR02B, 

26 mode) 

BCDB. (CR03B,029 mode) 
BCDB. (CR03B,026 mode) 
BCDB. (CR01E,CR02B, 

029 mode) 
BCDB. (CR01E,CR02B, 

026 mode) 



CD. DOS 012 
CD. DOS 012 
CD. DOS 012 
CD. DOS 012 



CD. DOS 012 
CD. DOS 012 



DOSBCD 003 
DOSBCD 00 3 
DOSBCD 003 

DOSBCD 003 



none 

DEC026=0 

CR15=0 

CR15=0 

DEC026=0 



NOTGDI=0 
NOTGDI=0 
DEC026=0 

none 

DEC026=0 

NOTGDY=0 

NOTGDI=0 
DEC026=0 



Any number of positive .DAT slots over 20 requires reassembly of 
FIOPS and .FLTB. These sources may be purchased from Digital 
Equipment Corporation under the following order number: 
DEC-15-SRDA-U11. Assembly parameter for .FLTB is: 
Assembly parameter for FIOPS is: STTBSZ=n<77o . 



FLTBSZ=n<77g. 
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APPENDIX D 



SYSF5LK 010 SVSBLK D0S15 

, TITLE SYSBuK DoS15 

/ 

/COPYRIGHT 1971, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS, 

/ 

/EDIT #010 9-.2^-7l 
/ 

/ SYSBLK (SYSTEM BLOCKS #34 AND 35(8)) CONTAlMS THE PARAMETERS FOR 

/LOADING ALL THE COKE IMaGE FILES (SYS FILES) ON THE D0Sl5 

/SYSTEM EXCEPT FOR ThE DaTA FILES SGNBLK(#36) 

/AND SYSBLK, SYSBLK IS PART OF THt SYSTEM LOADER AND NON-RESIDEnT MONITOR AND 
? /STARTS AT LOCATION 16100(8), THE ORDER OF ENTRIES IN SYSBLK IS 

^ /UNIMPORTANT EXCEPT FOR THE FIRST i PERMANENT ENTRIES, THIS TABLE IS USED BY 

/PATCH, SGEN, THE SYSTEM LOADER, AND THE NON-RESIDENT MONITOR. 

/THIS TABLE IS MODIFIED WHEN 

/NECESSARY BY SGEN AND PATCH, THE FIRST WORD OF SYSBLK CONTAINS 

/THE UNRELOCATED ADDRESS OF THE FIRST FREE WORU OF SYSBLK, THE 

/ENTRIES CONSIST OF 7 WORDS, THE FOLLOWING 

/DESCRIPTION APPLIES TO ALL 7 WORD ENTRieSj 

.SIXBT 'N^ME' 
FIRST BLOCK # (FB) 
# OF BLOCKS OCCUPIED (NB) 
FIRST ADDRESS (FA) (l3 BITS) 
PROGRAM SI^E (PS) (HIGHEST ADDRESS - FA+1) 
START ADDRESS (SA) (13 BITS) 

/POINTER TO FIRST FREE WORD OF SYSRLK 







/ 


W01,WD2 






/ 


WD3 






/ 


WD4 






/ 


WD5 






/ 


WD6 






/ 


WD7 






/ 


,ABS 


00000 






,LOC 


C 


y00i^42 


SYSBLK 


END 
.EJECT 



SYSRLK 010 



SYSBlK D0S15 





00001 


2?0523 




00002 


151716 




00003 


000000 




00004 


000040 




00005 


000100 




00006 


017400 




00007 


000000 




00013 


562331 




00011 


2314^4 




00012 


00004^ 




00013 


^^00013 




00014 


km000 


1 


00015 


t^05l0C^ 


KJ 


00016 


011000 




00017 


362101 




00020 


220501 



00021 000101 



00022 
00023 
00024 
00025 



000200 
000005 
077773 

000000 



/ 

/ THE FOLLOWING THREE ENTRIES ARE fIxED I N SYSBLK ANO CAN NEVER 

/BE DELETED, THEY KePRESENT THE BASIC SYS FILE CUSPS TO RUN THE 

/SYSTEM AND THE CONTROL Q AREA, 

/ 

SEl .SIXBT 'RESmON' 



40 

100 

17400 



.SIXBT '.SYSLD' 

40 

13 

11000 

5100 

11000 

, SIXBT 



SE2 



SE3 



' tQAREA' 



.IFUND RP0i2 

101 

,ENDC 

.IFDEF RP02 

117030 

,ENDC 

200 

5 

77773 



.EJECT 



D 
I 

CO 



00t^26 


050411 


006^27 


2 4 00 


0(Si;^30 


000317 


00(?3l 


000015 


00032 


f^lil35 


00033 


006007 


3 4 


wll404 


00035 


050411 


00 36 


242620 


00037 


000334 


30040 


000017 


00041 


010121 


00042 


^06755 


00043 


n 4 2 


00044 


'150411 


00045 


242624 


00046 


000353 


00047 


000017 


00050 


01013!^ 


00051 


^106773 


00052 


010406 


00053 


201120 


00054 


000000 


00055 


000372 


00056 


000035 


00057 


001343 


00060 


016274 


00061 


001506 


00062 


210611 


00063 


140500 


00064 


000427 


00065 


000002 


00066 


017041 


00067 


000437 


00070 


017045 


00071 


150103 


00072 


22170^^ 


00073 


000431 


00074 


mm:hh 


00075 


002630 


00076 


V11500'? 


000 7 7 


002630 



/ 

SE5 



/ 

se:6 



SE7 



SE10 



SEll 



/ 

SEa.2 



THIS ENT«Y BtGINs THE DELETEABUE CORE IMAGE CUSPS 
.SIXBT 'EDIT' 

317 

15 

1H35 
6007 
11404 

, SIXBT 'EDITVP' 



334 

17 

10121 

6755 

10402 
, SIXBT 



353 
17 

10130 
6773 
10406 
, SIXBT 



'EDITVT» 



•PiPpf 



372 

35 

1343 

16274 

1506 

, SIXBT 'QFIlE' 

427 
2 

17041 

437 

17045 

, SIXBT 'MACRO' 

431 

33 

2630 

15005 

2630 



D 



'^ Hi 017. 


')Z22l-5 


V? 1 1 


6 0^ 


0010;? 


.300464 


010 3 


(/■0P:^'J5 


00104 


^^IS&SD 


00105 


002007 


00106 


015551 


00107 


031001 


00110 


11160.1 


00111 


000471 


00112 


000021 


00113 


00724^ 


00114 


010377 


00115 


007240 


00116 


r^ 6 6 4 .5 


!30117 


000000 


00120 


000512 


00121 


000035 


00122 


002061 


00123 


'^15556 


00124 


002206 


00125 


4 2 515 


00126 


200000 


00127 


000 5 4 7 


00130 


000005 


00131 


015300 


00132 


002337 


00133 


015300 


00134 


1.542403 


00135 


172031 


00136 


000554 


00137 


000003 


00140 


(n 6 6 6 2 


00141 


000755 


00142 


116701 


00143 


200124 


00144 


031000 


00145 


000557 


00146 


000010 


00147 


012700 


00150 


003463 


00151 


012700 



SE13 



/ 

SE14 



/ 

3E15 



/ 

SE16 



/ 

SE17 



/ 

SE20 



.SIXBT 'CREF' 

464 

5 

15550 

2007 

15551 

, SIXBT 'CHAirgi 

471 

21 

7240 

10377 

7240 

, SIXBT 'F4P*' 

512 
35 

2061 
15556 

2206 

, SIXBT 'DUMP» 

547 
5 

15300 

2337 

15300 

, SIXBT 'DTCoPY' 

554 

3 

16662 
755 

16701 

.SIXBT 'PATCH' 

557 

10 

12700 

3463 

12700 

.EJECT 






2215? 


?52^e4 


3E21 


.SIXBT 


'UPOATE' 


00115J 


^12405 








0P1154 


000567 




567 




00155 


000013 




13 




00156 


012370 




12370 




00157 


005247 




5247 




00160 


012371 


SE22 


12371 




00161 


232203 


.SIXBT 


♦SRCCOM' 


00162 


031715 








00163 


000602 




602 




00164 


000013 




13 




00165 


012647 




12647 




00166 


04 7 7 




4770 




30167 


312752 




12752 




00170 


702422 


SE23 


.SIXBT 


'8THAN' 


00171 


?iii60>:^ 








00172 


000615 




615 




00173 


000011 




11 




00174 


M13607 




13607 




00175 


00403?' 




4030 




00176 


i?l3671 




13671 




00177 


707124 


SE24 


, SIXBT 


»89TRANf 


00200 


220116 








00201 


000626 




626 




00202 


000011 




11 




00203 


013562 




13562 




00204 


004055 




4055 




00205 


013644 




13644 




00206 


152404 


SE25 


, SIXBT 


♦MTOUMP' 


00207 


251520 








00210 


000637 




637 




00211 


000012 




12 




00212 


013167 




13167 




00213 


00445:3 




4450 




00214 


013260 


/ 

SE26 


13260 




00215 


230705 


, SIXBT 


'SGEN' 


00216 


160000 








00217 


000651 




651 




00220 


000022 




22 




00221 


005545 




5545 




00222 


010356 




10356 




00223 


005613 




5610 




00224 


2413^2 


SE27 


, SIXBT 


•TKB(?» 


00225 


i^T^i^Qdd 









D 
I 



00226 


00 70 6 


00227 


000021 


00230 


007573 


00231 


010044 


00232 


00775;? 


i30233 


7.41723 


00234 


616500 


00235 


000727 


00236 


000035 


00237 


000677 


00240 


015201 


00241 


001276 




000242 



SEi0 



706 

21 

7573 

10044 

7750 

.SIXBT 

727 

35 

677 

15201 
1276 



'D0S15' 



END=, 



.TITLE COMBlK DoS15 



D 
I 







/ 
/ 

/ 


COMBLK CONTAINS INFORMATI 






/NON-RESIDENT MONITOR, AND SYSTEM 






/ABOUT 


CURRENT SYS FILE CUSPS, 






/THE LAST LOCATION IN SYSBLK CONT 






/UNRELOCATED ADDRESS OF THE FIRST 






/REMAINDER OF COMBLK CONSISTS OF 






/WITH ! 


SYS FILE CUSPS (COrE IMAGE 






/ENTRY 


IS OF THE FOLLOWING FORMi 






/ 


(1) THE FIRST WORD IS AN 






/ 


NUMBER OF WORDS IN TH 






/ 


WORD, 






/ 


(2) THE NEXT TWO WORDS CO 






/ 


IF THE NAME iS LESS T 






/ 


TRAILING CHARACTER PO 






/ 


CHARACTER POSITION MU 






/ 


(3) IF THERE ARE ANY OVER 






/ 


ARE ENTERED AFTER THE 






/ 


(4) WHEN A WORD HAS 0'S I 






/ 


IS RIGHT AFTER THE CU 






/ 


IT TERMINATES THE LIS 






/ 


OF THIS WORD CONTAINS 






/ 


COMMAND FOR THE CUSP, 






/ 


<5) THE REMAINDER OF THE 






/ 


.DAT SLOT NUMBERS FOR 






/ 


(EXCEPT THAT '1 INDIC 






/ 


ARE TO BE LOADED) , 






/THE SYSTEM GENERATOR ADDS CUSPS 






/FIRST 


ENTRY, IN THIS WaY SYSBLK 


00600 




/ 


,LOC 600 


fssieaoi 


000005 


/ 

El 


E3-E1 


00601 


041723 




.SIXBT •D0Si5» 


00602 


616500 






00603 


000001 




1 


00604 


000766 




«i2«777 

, EJECT 



ON THE SYSTEM LOADER, THE 
GENERATOR NEED TO REMEMBER 

AiNS The 

ENTRY IN COMBLK. THE 
VARIABLE LENGTH ENTRIES ASSOCIATED 
SYSTEM PROGRAM FILES), EACH 

OFFSET NUMBER INDICATING THE 
E ENTRY INCLUDING THE OFFSET 

NTAIN the name OF THE CUSP IN , SIXBT 
HAN SIX CHARACTERS IN LENGTH, THE 
SITIONS ARE ZEROED. THE FIRST 
ST BE N0N,p2ER0, 

lay segments, their two word names 

first name above (2), 
n bit positions 0*5, and it 
sp name or an overlay name, 
t of segment names, the remainder 

the default value for the 'files' 

comblk entry contains the active 
the cusp with bits 0«8 zeroed 
ates That all positive ,dat slots 



TO COMblK BY MAKING THEM THE NEW 
AND COMBLK BUILD TOWARD THE CENTER', 



00605 


000007 


mtzd 


050411 


00607 


240000 


00610 


000002 


00611 


000763 


00612 


000764 


00613 


000770 


00614 


000010 


00615 


050411 


00616 


242620 


00617 


000002 


00620 


000763 


00621 


000764 


00622 


000770 


00623 


000010 


00624 


000007 


00625 


050411 


00626 


242624 


00627 


000002 


00630 


000763 


00631 


000764 


00632 


000770 


00633 


000005 


00634 


201120 


00635 


000000 


00636 


000004 


00637 


777777 


00640 


000013 


00641 


150103 


00642 


221700 


00643 


032205 


00644 


060000 


00645 


000003 


00646 


000764 


00647 


000765 


00650 


000766 


00651 


000767 


00652 


000770 



E3 E4-E3 

•SIXBT 'EDIT' 



2 /# OF BUFFERS Req FOR EDIT. 

''194777 

•144777 

-10«777 



/ 

E4 E4A^E4 



.SIXBT 'EOITVP' 

2 /# OF BUFFERS Req FOR EDITVP. 

"134777 

-144777 

"104777 

10 



E4A E5' 



.SIXBT 'E0ITVT» 



V wiooi;/ 000002 2 

CO 



-154777 
•144777 
wl04777 

/ 

E5 E6«E5 



.SIXBT »PIP*i 



4 



/# OF BUFFERS REQ FOR PIP, 



/ 

E6 E7-E6 



1 /ALU POSITIVE ,DAT SLOTS 



, SIXBT 'MACRO' 
, SIXBT 'CREF' 

3 

"144777 

•134777 

«124777 

«114777 

-5.04777 



D 
I 

VD 



00653 


00001?^ 


00654 


(?^31001 


00655 


111600 


00656 


000003 


00657 


000772 


00660 


000773 


00661 


000774 


00662 


000777 


00663 


000007 


00664 


66 4 00 


00665 


000000 


00666 


000003 


00667 


000765 


00670 


000766 


00671 


000767 


00672 


000006 


00673 


042515 


00674 


200000 


00675 


000002 


00676 


000764 


00677 


000766 


00700 


000006 


00701 


042403 


00702 


172031 


00703 


000002 


00704 


000763 


00705 


000764 


00706 


000006 


00707 


200124 


00710 


031000 


00711 


000002 


00712 


000764 


00713 


000770 



E7 



E8 



/ 

E9 



/ 

E10 



Ell 



E8-E7 
.SIXBT 

3 

-6«777 

-54777 

^44777 

-14777 

E9-E8 

, SIXBT 



"134777 
^124777 
-114777 

E10-E9 
, SIXBT 



-144777 
-124777 

E11-E10 
, SIXBT 



-154777 
-144777 

E12-E11 
, SIXBT 



-144777 
-104777 



'CHAIN« 



»F4C'»«ii 



•DUMP' 



'DTCOPY' 



•PATCH» 



00714 


000010 


E12 


E13-E12 




00715 


252004 




.SIXBT 


'UPUATE' 


00716 


012405 








00717 


000004 




4 




00720 


000763 




^154777 




00721 


000764 




-144777 




00722 


000766 




«^12«777 




00723 


000770 


/ 
E13 


^104777 




00724 


000007 


E13A-E13 




00725 


232203 




, SIXBT 


'SRCCOM' 


00726 


031715 








00727 


000003 




3 




00730 


000763 




-.154777 




00731 


000764 




*144777 




00732 


000766 




-124777 




00733 


000006 


E13A 


E13B., 




00734 


702422 




.SIXBT 


'8TRAN' 


00735 


011600 








00736 


000002 




2 




00737 


000763 




-154777 




00740 


000764 




«144777 




00741 


000006 


E13B 


E13C-, 




00742 


707124 




, SIXBT 


•89TRAN' 


00743 


220116 








00744 


000002 




2 




00745 


000763 




-154777 




00746 


000764 




-144777 




00747 


000006 


E13C 


E13D", 




00750 


152404 




, SIXBT 


'MTOUMP' 


00751 


251520 








00752 


000002 




2 




00753 


000001 




1 




00754 


000003 




3 




00755 


000005 


E13D 


E14«. 




00756 


210611 




, SIXBT 


•QFILE' 


00757 


140500 








00760 


000001 




1 




00761 


000764 




-144777 








00762 


000005 


f 

E14 


El5..Et4 




00763 


230705 




.SIXBT 


'SGEN 


00764 


160000 








00765 


000001 




1 




mibt 


000764 




«14«777 




miti 


000010 


E15 


E16-, 




00770 


241302 




, SIXBT 


'TKBe» 


00771 


000000 








00772 


000003 




3 




00773 


000772 




't&lll 




00774 


000773 




•^b&lll 




00775 


000774 




-^Ailll 




0ii776 


000777 
000777 


E16=, 


'i&lll 




mill 


000600 
000000 


comblk 


El 
.END 






SIZE' 


:01000 


NO ERROR 


LINES 



/POINTER TO THE FIRST ENTRY IN COMBLK 



.TITLE SGNHLK DoS15 

/COPYRIGHT 1971, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS, 
/' 

/EDIT «008 9ii9<;'7l 
/ 

/ SGNBLK (SYSTEM BLOCK #36(8)) CONTAINS ALL THE SYSTEM PARAMETERS 
/NOT ASSOCIATED DIREcTLY WITH SYS FILE CUSPS. THE BULK OF SGNBLK 
/IS CONCERNED WITH I/O (.DAT SLOTSi.UFD SUOTS, SKIP CHAIN ORDER, HANDLERS, 
/SKIP IDT NUMBCRS AND MNEMONICS). THE FiRST FEW REGISTERS OF SGNBLK 
/HOLD SUCH IMPORTANT SYSTEM PARAMETERS AS THE SYSTEM DEVICE, 
/ ,SC0M*4 CONTENTS, ETC, SGNBLK IS PART OF THE 
/SYSTEM LOADER AND NON. RESIDENT MONITOR aND STARTS AT LOCATION 
D /17100(8), THE FIRST 

^ /WORD IN SGNBLK POINTS To THE UNREUOCATed ADDRESS OF THE FIRST FREE 

*^ /WORD IN THE BLOCK, THE NEXT ENTRY IS AN OFFSET WORD INDICATING 

/THE TOTAL LCNPTH (INCLUDING ITSEL^) OF tHe MISCELLANEOUS 
/SYSTEM PAJAMCTER TABLE fO FOLLOW, THIS TABLE INCLUDES THE SI2E OF 
/THE .DAT SLOT TABLE AND THE SIZE OF THE SKIP CHAIN TABLE, THE END 
/or THE HANDLED AND SKIP lOT TABLE IS The FIRST FREE ENTRY OF THE BLOCK, 

.ABS 
00000 ,LOC 

00000 000313 SGNBLK .SIZE /POINTER TO FIRST FREE ENTRY IN SGNBLK 







SGNBLK 


008 SGnBLK D0S15 










.IFDEF 


RP02 








SYSDEV" 


il7 
.ENDC 
, IFUND 


RP02 






000014 


SYSDEVi 

/ 

/BASIC 
i 


»14 
,ENDC 










SYSTEM PARAMET 




00001 


000015 


/ 

NOPAR 


SGNDAT* 


'• 




00002 


000074 


NODAT 


SGNSKP- 


•SGNDAT 




00003 


000026 
000004 


NOSKP 
SDEVl*, 


SGNTAB" 

•IFDEF 
, SIXBT 
,ENDC 


'SGNSKp 

RP02 
/DP/ 


D 








•IFUND 


RP02 


1 


00004 


041300 




•SIXBT 


/DK/ 


00 








,ENDC 






00005 


300500 


SC0M4 


300500 






00006 


000000 


SCOM20 









00007 


000500 


XI 


500 






00010 


000003 


FILES 


3 






00011 


233123 


MIC 


•SIXBT 


'SYS» 




00012 


000000 


SC0M33 









00013 


000002 


PROTCT 


2 






00014 


000000 


PCHSZ 









00015 


777704 


CLKCON 


«74 





ERS 



/NUMBER OF MISCELLANEOUS PARAMETERS 
/(NUMBER OF POSITIVE ,DAT SLOTS * 16)«2 
/EQUALS SIZE OF .DAT SLOT TABLE AND .UFD 
/NUMBER OF SKlPs IN THE SKIP CHAIN 
/SYSTEM DEVICE CODE 



TABLE 



FILE ON MASS 



/ORIGINAL CONTENTS OF ,SC0M*4 

/ORIGINAL CONTENTS OF ,SCOM+20 

/NUMBER OF DATA REGISTERS PER OPEN 

/STORAGE <iSC0M-^27) 

/DEFAULT NUMBER oF FILES TO BE OPEN AT SAME TIME 

/FOR USE WITH The LINKING LOADER AND EXECUTE 

/THE MONITOR IDENTIFICATION CODE 

/tX INFORMATION (,SC0M*33) 

/DEFAULT PROTECTION CODE FOR FILES (.SCOM+54) 
rEaD/WRITE (WITH RANDOM ACCESS) 

rEad/no write 

NO READ/NO WRITE 
RESIDENT MONITOR PATCH AREA 
IN A SECOND («74 FOR 



( •SCOM + 26) 



/ 1 
/ 2 
/ i 

/SIZE OF THE 
/-# OF TICKS 



/60 CPS AND -62 FOR 50 CPS) 



.TITLE .OAT SLOTS TABLE 



00016 

00017 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00030 

00031 

00032 

00033 

00034 

00035 

00036 

00037 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00050 

00051 

00052 

00053 



300014 
000014 
000014 
000001 
000014 

!^00001 

100003 
000014 
000000 
000014 
100000 
100000 
000014 
100000 
000014 
000014 
000014 
000001 
000002 
000004 
100007 
200007 
000000 
000000 
000000 

000000 
000000 

000000 
000000 

000000 



/ 
/ 

/OF . 

/THE 

/EXCE 

/UNIT 

/JUST 

/THE 

/TTA 

/.OAT 

/ 

SGNDA 



THIS ,DAT 
DAT SLOTS WI 
MAXIMUM POSI 
ED 77(8), T 

NUMBER IS I 
IFIED IN BIT 
DEVICE HANDL 
IS 1 ETC, T 

SLOT, THESE 

T SYSOEV 
SYSOEV 
SYSDEV 
1 

SYSDEV 
1 

100000 
SYSDEV 

SYSDEV 

100000 

100000 

SYSDEV 
100000 

SYSDEV 

SYSDEV 

SYSDEV 

1 

2 

4 

100007 

200007 



















SLOT TABLE CORRESPONDS TO THE LEGAL RANGE 
TH THE MAXIMUM NEGATIVE ,DAT SLOT SET To -15 AND 
TIVE ,DaT slot SET TO A SYSTEM PARAMETER NOT TO 
HE .DAT SLOTS ARE IN The SAME FORM AS BEFORE. THE 
N BITS 0"2 AND THE NUMbe^ OF THE HANDLER RIGHT 
S 3«18, THE HANDLER NUMBER FOR THE FIRST HANDLER IM 
ER"SKIP lOT TABLE IS (Fqr THE PSEUDO-HANDLER NON ) . 
HE CONSTANT 100000 INDICATES A FIXED OR ILLEGAL 

SLOTS ARE NOT SET BY SGEN, 

/"15 

/"i4 

/'•13 

/''12 

/"ll 

/'•10 

/»7 

/*6 

/•5 

/"4 

/*i3 

/«2 

/'% 

/0 

/I 

/2 

/3 

/4 

/5 

/6 

/7 

/10 

/U 

/X2 

/13 

/14 

/15 

/16 

/17 

/20 







/ 


• UFD T 






/TABLE, 


AN EN 






/UIC IS 


ro BE 






/THE CONTENTS 






/THE CORRESPON 

y 


00054 


251103 


/ 

SGNUFD 


.SIXBT 


00035 


251103 




.SIXBT 


00056 


251103 




.SIXBT 


00057 


251103 




.SIXBT 


00060 


251103 




.SiXBT 


00061 


251103 




.SiXBT 


00062 


233123 




.SIXBT 


00063 


251103 




iSlXBT 


00064 


251103 




iSIXBT 


00065 


251103 




.SIXBT 


00066 


251103 




SIXBT 


00067 


251103 




SIXBT 


00070 


233123 




SIXBT 


00071 


233123 




SIXBT 


00072 


251103 




SIXBT 


00073 


251103 




SIXBT 


00074 


251103 




SIXBT 


00075 


251103 




SIXBT 


00076 


251103 




SIXBT 


00077 


251103 




SIXBT 


00100 


251103 




SIXBT 


00101 


251103 




SIXBT 


00102 


251103 




SIXBT 


00103 


251103 




SIXBT 


00104 


251103 




SIXBT 


00105 


251103 




SIXBT 


00106 


251103 




SIXBT 


00107 


251103 




SIXBT 


00110 


251103 




SIXBT 


00111 


251103 




SIXBT 



TITLE .UFU TABLE 

TABLE Is IN 1 TO 1 COHRESPqnDENCE WITH THE ,DAT SLOT 
TRY OF , SIXBT 'UIC INDICATES THAT THE LOGIN 
SUBSTITUTED FOR THE NAME UlC IN THE TABLE, OTHERWISE 
OF EACH LOCATION WILL BE THE , SIXBT REPRESENTATION OF 
DING lUFD SLOT, 



'UIC 
'UIC 
♦UIC 
•UIC 
'UIC 
'UIC 
'SYS 
'UIC 
'UIC 
'UIC 
'UIC 
'UIC 
'SYS 
•SYS 
'UIC 
'UIC 
•UIC 
'UIC 
'UIC 
'UIC 
'UIC 
'UIC 
• UIC 
'UIC 
'UIC 
'UIC 
'UIC 
'UIC 
'UIC 
♦UIC 



/-15 

/«13 
/-.12 

/-ii 

/"3,0 

/^7 

/•6 

/-5 

/-4 

/mi 
fm2 
/-I 

n MIC 
/I 

/2 
/3 
/4 
/5 
/6 

n 

/lfe5 

/u 

/12 

/IJ 

/l^ 
/l^ 
/16 
/17 
/2fc' 



I 



00112 
00113 



703201 
707601 



00114 707001 



00115 


706341 


00116 


707341 


00117 


703121 


00120 


703261 


00121 


700521 


00122 


706701 


00123 


706721 


00124 


706501 


00125 


700001 


00126 


700101 


00127 


700201 


00130 


700301 


00131 


704101 


00132 


700401 


00133 


707561 


00134 


706361 


00135 


701741 


00136 


701701 


00137 


702701 



.TITLE SKIP CHAIN TABLE 
/ 

/ THE SKIP CHAIN TABLE LIS^S THE SYSTEM SKIP lOTS IN ORDER 

/ A UEGATIVE SKIP ApPtARS IN TH": TABLE I.J I'S COMPLEMENT ( PQS I T I VE ) . 

/riOT ALL THE SKIPS IN THk HANDLEF<-Sk I P TnT TaBLF; NEED TO BE INCLUDED IN 

/^HIS TABLE, THE DONE COMMAND IN' SgeM caM BE USED TO TERMINATE 

/THE SKIP CHAIN BUILDING AT ANY SIZE, THIS EFFECTIVELY DELETES THE 

/REMAlNlNGi UNLISTED SKIpS FROM THE SKIP CHAIN, 

/ 

SGNSkP 



703201 


/spfal 


707601 


/DTDF 


.IFUNO 


RB0V 


707001 


/DSSF 


lENOC 




.JFDEF 


RB0V 


707121 


/DSSF 


,ENDC 




706341 


/DPbj 


707341 


/MTSF 


703121 


/SPDI 


703261 


/WTSk 


700521 


/SODF 


706701 


/RCSF 


706721 


/RCSD 


706501 


/LSOF 


700001 


/CLSF 


700101 


/RSF 


700201 


/PSF 


700301 


/KSF 


704101 


/SPKF 


700401 


/TSF 


707561 


/DTEF 


706361 


/DPSE 


701741 


/MPSnE 


701701 


/mpsk 


702701 


/SPE 






00140 


161716 


00141 


000005 


00142 


031423 


00143 


060000 


00144 


700001 


00145 


152023 


00146 


160500 


00147 


701741 


00150 


152023 


00151 


130000 


00152 


701701 



.TITLE DEVICE HaNDLER-SKIP IOT 
/ 
/ THE DEVICE HaNDLER-SK I P lOT TABl 

/AND Skip jot numbehs and mnemonics for 

/SYSTEM, EVERY DEVICE HaS AN ENTRY IN j 
/NAME MUST BE EXACTLY 3 CHARACTERS IN LF 
/NOT AN OCTAL DIGIT, THE DEVICE C^DE Fq 
/CHARACTERS, THE FIRST 2 CHARACTERS OF 
/DEVICE MUST BE THE DEVIcE CODE, THIS F 
/ING THE FORMAT OF A DEVjCE ENTRY, SINCf 
/STORED AS SUCH IN An ENTRY, BUT IS INFe 
/NAMES, THE TYPICAL ENTRY FOR A DEVICE 
/ (1) THE FIRST WORDS OF AN ENTRY 
/ FOR A DEVICE IN ,SIXBTi EAc 

/ A3 CHARACTER HANDLER NAME I 

/ 1 COMPUTER WORD, THE END OF 

/ BY A WORD WITH 0'S IN BjTS 

/ (2) THE WORU THAT TERMINATED (1) 
/ lOTS FOR THE DEVICE, FOR Ea 

/ TABLE, THE FOLLOWING IS A R 

/ (A) THE FIRST 2 WqRDS AR 

/ REFERRING TO THE SKI 

/ TRAILING CHARACTER P 

/ SKIP MNEMONIC MyST N 

/ (B) THE LAST WORD ABOUT 

/ INSTRUCTION NUMBER F 

/ SKIP IS NEGATIVE THi 

/ OF The actual machin 



TABLE 
F CON 

fach 
me ta 
ngth 

RAD 
EACH 
ACT I 

The 

RRED 
IS TH 

cOnta 

H HAM 
N .SI 

The 

-5 (F 

CONT 
C^ SK 

epres 

F THE 
P SYM 
OSITI 
OT EX 
THE S 
qR TH 
S NUM 
E INS 
SKIP 
IPs 
mE, 



/THE NEXT DEVICE ENTRY FOLLOWS THE LAST 

/A HANDLER MAY BE ENTERED WITHOUT ANY Sk 

/ENTERED WITHOUT AT LEAST ONE HANDIER NA 
/ 

SGNTAB ,SIXBT 'NON' /DEy HAND, 

5 /5 SKIPS 

.SIXBT 'ClSF' /clock D 



TAINS ALL THE HANDLER NAMES 

I/O DEVICE KNOWN TO THE 

BLE, A HANDLER 

WITH THE LAST CHARACTER 

EVICE IS EXACTLY 2 

HANDLER NAME FOR A 

S ESSENTIAL FOR UNDERSTaNO- 

DEVICE CODE IS NEVER 

FROM THE DEVICE HANDLER 

E FOLLOWING: 

IN THE HANDLER NAMES 

DLER NAME IS DIFFERENT, 

XBT NEATLY FITS INTO 

LIST IS DETERMINED 

IRST CHARACTER POSITION) , 

AINS THE NUMBER OF SKIP 

IP IOT 3 WORDS ARE IN THE 

ENTATION OF THESE 3 WORnSl 

Skip mnemonic used for 

BOLICLY IN .SIXBT WITH 

ONS CONTAINING 0'S. THF 

CEEO 6 CHARACTERS, 

KIP IS THE ACTUAL MACHINE 

E SKIP IOT, IF THE 

BER WILL BE I'S COMPLEMFNT 

TRUCTION (POSITIVE). 

FOR THE PREVIOUS DEVICE'. 

BUT NO DEVICES MAY BE 



700001 

, SIXBT 'MPSnE' 

701741 

, SIXBT »MPbK» 

701701 



lONE 

/NON-EXISTENT MEMORY REFERENCE 
/MEMORY PROTECT VIOLATION 



D 

M 
00 



00153 


P32005 


00154 


300000 


00155 


702701 


00156 


232006 


00157 


311400 


00160 


703201 


00161 


242401 


00162 


000002 


00163 


132306 


00164 


000000 


00165 


700301 


00166 


242306 


00167 


000000 


00170 


700401 


00171 


202201 


00172 


202202 


00173 


000001 


00174 


222306 


00175 


000000 


00176 


700101 


00177 


202001 


00200 


202002 


00201 


202003 


00202 


000001 


00203 


202306 


00204 


000000 


00209 


700201 


00206 


042401 


00207 


042403 


00210 


042404 


00211 


042405 


00212 


042406 


00213 


000002 


00214 


042404 


00215 


060000 


00216 


707601 


00217 


042405 


00220 


060000 


00221 


707561 



DEVI 



DEV2 



DEV3 



DEV4 



.SIXBT 


'SPE.»' 


702701 




, SIXBT 


'SPFaL' 


703201 




.8IXIT 


'TTAt 


2 




.SIXBT 


'KSFjil 


700301 




.SKXBT 


'TSF^i 


700401 




.SIXBT 


•PRA» 


, SIXBT 


'PRB» 


t 




.SIXBT 


'RSFjbl 


700101 




, SIXBT 


tppAt 


.SIXBT 


ippB' 


.SIXBT 


• PPCf 


1 




, SIXBT 


ipSF^f 


700201 




, SIXBT 


'DTA» 


.SIXBT 


• DTC» 


•SIXBT 


♦DTD» 


.SIXBT 


'DTE' 


, SIXBT 


• DTFi 


2 




.SIXBT 


♦DTOF' 


707601 




.SIXBT 


•OTEF' 



/MEMORY PARITY ERROR 



/POWER FAIL 



/DEVI HanD.1 
/2 SKIPS 

/KEYBOARD DONE 



/TELEPRINTER DONE 



/DEV2 Hand, 2 

/HAND, 3 
/I SKIP 
/READER DONE 



/HAND, 4 
/HAND, 5 
/HAND, 6 
/I SKIP 
/PUNCH DONE 



/HAND, 7 
/HAND, 10 
/HAND, 11 
/HAND, 12 

/HAND, 13 

/dectape Done 



/dectape Error 



707561 



00222 


041301 


00223 


041302 


00224 


041303 


00225 


000001 


00226 


042323 


00227 


060000 



QEVS 



00230 707001 



00231 


042001 


00232 


042002 


00233 


042003 


00234 


000002 


00235 


042023 


00236 


120000 


00237 


706341 


00240 


042023 


00241 


050000 


00242 


706361 


00243 


152401 


00244 


152403 


00245 


152406 


00246 


000001 


00247 


152423 


00250 


060000 


00251 


707341 


00252 


142001 


00253 


000001 


00254 


142304 


00255 


060000 


00256 


706501 



DEV6 



DEV7 



DEV10 



•SIXBT 


'OKA» 


/HAND, 14 




•SIXBT 


•DKBt 


/HAND, 15 




, SIXBT 


»DKCt 


/HAND, 16 




1 




/I SKIP 




, SIXBT 


♦DSSF' 


/DISK Done: 




.IFUNO 


RB0V 






707001 








.CNOC 








.IFDEF 


RB0V 






707121 








,ENDC 








.SIXBT 


•DPAt 


/HAND, 17 




.SIXBT 


'DPB» 


/HAND, 20 




.SIXBT 
2 


»DPC» 


/HAND, 21 




.SIXBT 


'DPSj! 


/DISK Done 




706341 








, SIXBT 


'dpse:i 


/DISK Error 




706361 








.SIXBT 


'MTA» 


/HAND, 22 




.SIXBT 


'MTQ' 


/HAND, 23 




.SIXBT 


»MTF» 


/HAND, 24 




1 




/I SKIP 




.SIXBT 


'MTSpi 


/MAGNETIC TAPE DONE ON ERROR 


707341 








.SIXBT 


'LPA» 


/HAND, 25 




1 




n SKIP 




, SIXBT 


♦LSQF' 


/LINE PRINTER DONE 





706501 



D 
I 

ro 
o 



00257 


030402 


00260 


000002 


00261 


220323 


00262 


060000 


00263 


706701 


00264 


220323 


00265 


040000 


00266 


706721 


00267 


262001 


00270 


000001 


00271 


230404 


00272 


060000 


00273 


700521 


00274 


262401 


00275 


000001 


00276 


232004 


00277 


110000 


00300 


703121 


00301 


262701 


00302 


000001 


00303 


272423 


00304 


130000 


00305 


703261 


00306 


141301 


00307 


000001 


00310 


232013 


00311 


060000 


00312 


704101 



DEVll 



DEV12 



DEV13 



DEV14 



DEV15 



.SIXBT 'CDBf 

2 

, SIXBT 'RCSF» 

706701 

, SIXBT 'RCSD' 

706721 

, SIXBT 'VPA' 

1 

, SIXBT 'SDOF' 



700521 
, SIXBT 
1 



/HAND, 26 
/2 SKIPS 
/CARD READER 



VTA' 



/HAND, 27 
/I SKIP 
/DISPLAY 



/HAND, 30J VT SCOPE DISPLAY 

/I SKIP; LIGHT PENJPUSH BUTTONj 



, SIXBT 'SPDp /INTERNAL AND EXTERNAL STOP 

7J?121 /OR EDGE VIOLATION ON VT 

, SIXBT »VWA. /HAND, 3lJ WRITING TABLET 

1 /I SKIP 

, SIXBT 'WTSK' /PEN CONTACT WITH TABLET 



703261 

.SIXBT 'LKAf 

1 

, SIXBT 'SPKF' 

704101 



/HAND 32j VT KEYBOARD LK35 

/I SKIP 

/L'<35 KEYBOARD DONE 



HOW TO OBTAIN SOFTWARE INFORMATION 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Pro^rnm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 



DOS - SGEN 

READER'S COMMENTS dec-15-ywzb-dn12 



Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors in this manual? If so, specify by page. 



How can this manual be improved? 



Other comments? 



Please state your position. Date- 
Name: Organization: 

Street: ^^ Department: 

^'^y= ^__ State: Zip or Country 



Fold Here 



Do Not Tear - Fold Here and Staple 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STAThS 



FIRST CLASS 

PERMIT NO. 33 

MAYNARD, MASS. 



Postage will be paid by: 




Digital Equipment Corporation 
Software Information Services 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 



